home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1995 July / macformat-026.iso / mac / Shareware City / Developers / berkeleydb1.73 / Berkeley_db / btree / bt_overflow.c < prev    next >
Encoding:
C/C++ Source or Header  |  1994-07-27  |  5.8 KB  |  229 lines  |  [TEXT/MPS ]
  1. /*-
  2.  * Copyright (c) 1990, 1993
  3.  *    The Regents of the University of California.  All rights reserved.
  4.  *
  5.  * This code is derived from software contributed to Berkeley by
  6.  * Mike Olson.
  7.  *
  8.  * Redistribution and use in source and binary forms, with or without
  9.  * modification, are permitted provided that the following conditions
  10.  * are met:
  11.  * 1. Redistributions of source code must retain the above copyright
  12.  *    notice, this list of conditions and the following disclaimer.
  13.  * 2. Redistributions in binary form must reproduce the above copyright
  14.  *    notice, this list of conditions and the following disclaimer in the
  15.  *    documentation and/or other materials provided with the distribution.
  16.  * 3. All advertising materials mentioning features or use of this software
  17.  *    must display the following acknowledgement:
  18.  *    This product includes software developed by the University of
  19.  *    California, Berkeley and its contributors.
  20.  * 4. Neither the name of the University nor the names of its contributors
  21.  *    may be used to endorse or promote products derived from this software
  22.  *    without specific prior written permission.
  23.  *
  24.  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  25.  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  26.  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  27.  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  28.  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  29.  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  30.  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  31.  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  32.  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  33.  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  34.  * SUCH DAMAGE.
  35.  */
  36.  
  37. #if defined(LIBC_SCCS) && !defined(lint)
  38. static char sccsid[] = "@(#)bt_overflow.c    8.1 (Berkeley) 6/4/93";
  39. #endif /* LIBC_SCCS and not lint */
  40.  
  41. #if defined(macintosh) && (defined(powerc) || defined(__powerc))
  42. #include "OurMalloc.h"
  43. #endif
  44.  
  45. #include <sys/param.h>
  46.  
  47. #include <stdio.h>
  48. #include <stdlib.h>
  49. #include <string.h>
  50.  
  51. #include <db.h>
  52. #include "btree.h"
  53.  
  54. /*
  55.  * Big key/data code.
  56.  *
  57.  * Big key and data entries are stored on linked lists of pages.  The initial
  58.  * reference is byte string stored with the key or data and is the page number
  59.  * and size.  The actual record is stored in a chain of pages linked by the
  60.  * nextpg field of the PAGE header.
  61.  *
  62.  * The first page of the chain has a special property.  If the record is used
  63.  * by an internal page, it cannot be deleted and the P_PRESERVE bit will be set
  64.  * in the header.
  65.  *
  66.  * XXX
  67.  * A single DBT is written to each chain, so a lot of space on the last page
  68.  * is wasted.  This is a fairly major bug for some data sets.
  69.  */
  70.  
  71. /*
  72.  * __OVFL_GET -- Get an overflow key/data item.
  73.  *
  74.  * Parameters:
  75.  *    t:    tree
  76.  *    p:    pointer to { pgno_t, size_t }
  77.  *    buf:    storage address
  78.  *    bufsz:    storage size
  79.  *
  80.  * Returns:
  81.  *    RET_ERROR, RET_SUCCESS
  82.  */
  83. int
  84. __ovfl_get(t, p, ssz, buf, bufsz)
  85.     BTREE *t;
  86.     void *p;
  87.     size_t *ssz;
  88.     char **buf;
  89.     size_t *bufsz;
  90. {
  91.     PAGE *h;
  92.     pgno_t pg;
  93.     size_t nb, plen, sz;
  94.  
  95.     memmove(&pg, p, sizeof(pgno_t));
  96.     memmove(&sz, (char *)p + sizeof(pgno_t), sizeof(size_t));
  97.     *ssz = sz;
  98.  
  99. #ifdef DEBUG
  100.     if (pg == P_INVALID || sz == 0)
  101.         abort();
  102. #endif
  103.     /* Make the buffer bigger as necessary. */
  104.     if (*bufsz < sz) {
  105.         if ((*buf = realloc(*buf, sz)) == NULL)
  106.             return (RET_ERROR);
  107.         *bufsz = sz;
  108.     }
  109.  
  110.     /*
  111.      * Step through the linked list of pages, copying the data on each one
  112.      * into the buffer.  Never copy more than the data's length.
  113.      */
  114.     plen = t->bt_psize - BTDATAOFF;
  115.     for (p = *buf;; p = (char *)p + nb, pg = h->nextpg) {
  116.         if ((h = mpool_get(t->bt_mp, pg, 0)) == NULL)
  117.             return (RET_ERROR);
  118.  
  119.         nb = MIN(sz, plen);
  120.         memmove(p, (char *)h + BTDATAOFF, nb);
  121.         mpool_put(t->bt_mp, h, 0);
  122.  
  123.         if ((sz -= nb) == 0)
  124.             break;
  125.     }
  126.     return (RET_SUCCESS);
  127. }
  128.  
  129. /*
  130.  * __OVFL_PUT -- Store an overflow key/data item.
  131.  *
  132.  * Parameters:
  133.  *    t:    tree
  134.  *    data:    DBT to store
  135.  *    pgno:    storage page number
  136.  *
  137.  * Returns:
  138.  *    RET_ERROR, RET_SUCCESS
  139.  */
  140. int
  141. __ovfl_put(t, dbt, pg)
  142.     BTREE *t;
  143.     const DBT *dbt;
  144.     pgno_t *pg;
  145. {
  146.     PAGE *h, *last;
  147.     void *p;
  148.     pgno_t npg;
  149.     size_t nb, plen, sz;
  150.  
  151.     /*
  152.      * Allocate pages and copy the key/data record into them.  Store the
  153.      * number of the first page in the chain.
  154.      */
  155.     plen = t->bt_psize - BTDATAOFF;
  156.     for (last = NULL, p = dbt->data, sz = dbt->size;;
  157.         p = (char *)p + plen, last = h) {
  158.         if ((h = __bt_new(t, &npg)) == NULL)
  159.             return (RET_ERROR);
  160.  
  161.         h->pgno = npg;
  162.         h->nextpg = h->prevpg = P_INVALID;
  163.         h->flags = P_OVERFLOW;
  164.         h->lower = h->upper = 0;
  165.  
  166.         nb = MIN(sz, plen);
  167.         memmove((char *)h + BTDATAOFF, p, nb);
  168.  
  169.         if (last) {
  170.             last->nextpg = h->pgno;
  171.             mpool_put(t->bt_mp, last, MPOOL_DIRTY);
  172.         } else
  173.             *pg = h->pgno;
  174.  
  175.         if ((sz -= nb) == 0) {
  176.             mpool_put(t->bt_mp, h, MPOOL_DIRTY);
  177.             break;
  178.         }
  179.     }
  180.     return (RET_SUCCESS);
  181. }
  182.  
  183. /*
  184.  * __OVFL_DELETE -- Delete an overflow chain.
  185.  *
  186.  * Parameters:
  187.  *    t:    tree
  188.  *    p:    pointer to { pgno_t, size_t }
  189.  *
  190.  * Returns:
  191.  *    RET_ERROR, RET_SUCCESS
  192.  */
  193. int
  194. __ovfl_delete(t, p)
  195.     BTREE *t;
  196.     void *p;
  197. {
  198.     PAGE *h;
  199.     pgno_t pg;
  200.     size_t plen, sz;
  201.  
  202.     memmove(&pg, p, sizeof(pgno_t));
  203.     memmove(&sz, (char *)p + sizeof(pgno_t), sizeof(size_t));
  204.  
  205. #ifdef DEBUG
  206.     if (pg == P_INVALID || sz == 0)
  207.         abort();
  208. #endif
  209.     if ((h = mpool_get(t->bt_mp, pg, 0)) == NULL)
  210.         return (RET_ERROR);
  211.  
  212.     /* Don't delete chains used by internal pages. */
  213.     if (h->flags & P_PRESERVE) {
  214.         mpool_put(t->bt_mp, h, 0);
  215.         return (RET_SUCCESS);
  216.     }
  217.  
  218.     /* Step through the chain, calling the free routine for each page. */
  219.     for (plen = t->bt_psize - BTDATAOFF;; sz -= plen) {
  220.         pg = h->nextpg;
  221.         __bt_free(t, h);
  222.         if (sz <= plen)
  223.             break;
  224.         if ((h = mpool_get(t->bt_mp, pg, 0)) == NULL)
  225.             return (RET_ERROR);
  226.     }
  227.     return (RET_SUCCESS);
  228. }
  229.